home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / nice.z / nice
Encoding:
Text File  |  2002-10-03  |  3.1 KB  |  66 lines
  1.  
  2.  
  3.  
  4. nnnniiiicccceeee((((2222))))                                                                nnnniiiicccceeee((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _nnnn_iiii_cccc_eeee - change priority of a time-sharing process
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  13.      _iiii_nnnn_tttt _nnnn_iiii_cccc_eeee_((((_iiii_nnnn_tttt _iiii_nnnn_cccc_rrrr_))))_;;;;
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _nnnn_iiii_cccc_eeee allows a process in the time-sharing scheduling class to change its
  17.      priority.  The _ssss_cccc_hhhh_eeee_dddd______ssss_eeee_tttt_ssss_cccc_hhhh_eeee_dddd_uuuu_llll_eeee_rrrr and _ssss_cccc_hhhh_eeee_dddd_cccc_tttt_llll system calls are more
  18.      general interfaces to scheduler functions.
  19.  
  20.      _nnnn_iiii_cccc_eeee adds the value of _i_n_c_r to the nice value of the calling process.  A
  21.      process's nice value is a non-negative number for which a more positive
  22.      value results in lower CPU priority.
  23.  
  24.      A maximum nice value of 39 and a minimum nice value of 0 are imposed by
  25.      the system.  (The default nice value is 20.)  Requests for values above
  26.      or below these limits result in the nice value being set to the
  27.      corresponding limit.
  28.  
  29.      _EEEE_PPPP_EEEE_RRRR_MMMM         _nnnn_iiii_cccc_eeee fails and does not change the nice value if _i_n_c_r is
  30.                    negative or greater than 40 and the effective user ID of
  31.                    the calling process is not super-user.
  32.  
  33.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL        _nnnn_iiii_cccc_eeee fails if called by a process in a scheduling class
  34.                    other than time-sharing.
  35.  
  36. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  37.      _eeee_xxxx_eeee_cccc(2), _ssss_eeee_tttt_pppp_rrrr_iiii_oooo_rrrr_iiii_tttt_yyyy(2), _ssss_cccc_hhhh_eeee_dddd______ssss_eeee_tttt_ssss_cccc_hhhh_eeee_dddd_uuuu_llll_eeee_rrrr(2).  _ssss_cccc_hhhh_eeee_dddd_cccc_tttt_llll(2).
  38.      _cccc_ssss_hhhh(1), _ssss_hhhh(1), _nnnn_iiii_cccc_eeee(1).
  39.  
  40. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  41.      Upon successful completion, _nnnn_iiii_cccc_eeee returns the new nice value minus 20.
  42.      Otherwise, a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the
  43.      error.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.